home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / progs / editor / frexxed / bin / frexxtool.doc < prev    next >
Text File  |  1995-07-17  |  3KB  |  94 lines
  1.             FrexxTool - An ARexx toolbox
  2.             ============================
  3.  
  4.             By Linus Nielsen and Daniel Stenberg
  5.  
  6.   This is a small utility that opens a window with buttons that execute
  7. ARexx commands when pressed. It reads a setup file with the button names
  8. and the commands they execute. It can open on any public screen and use
  9. any ARexx port.
  10.  
  11.  
  12. How to use it
  13. -------------
  14.  
  15. The CLI template is:
  16.  
  17. FrexxTool PORT/K,SETUP/K,SCREEN/K,COLUMNS/N/K,X/N/K,Y/N/K,HELP/S/K
  18.  
  19. The parameters:
  20.  
  21. PORT    -    The name of the ARexx port to use, default is FREXXED.1,
  22.         because this program is written mainly for FrexxEd usage.
  23.  
  24. SETUP    -    The name of the setup file, default is "FrexxTool.setup".
  25.  
  26. SCREEN    -    The name of the public screen to open on, default is
  27.         the current default public screen. If PORT is FrexxEd's
  28.         port, it will ask FrexxEd which screen to use, if SCREEN is
  29.         not specified.
  30.  
  31. COLUMNS    -    The number of columns to use when placing the gadgets,
  32.         default is 3.
  33.  
  34. X    -    The window X position, default is 0.
  35.  
  36. Y    -    The window Y position, default is 0.
  37.  
  38. HELP    -    Display a helpful(?) text.
  39.  
  40.  
  41.  
  42. The setup file
  43. --------------
  44.  
  45.   The setup file, by default called 'FrexxTool.setup' has a very simple
  46. format: '<label>:<command>' where the command ends at the newline character.
  47. The label should for cosmetic reasons be short and immediately followed by a
  48. colon, and then the message that will be sent to FrexxEd when that button
  49. is pressed. One line should *not* be longer than 512 bytes, and there is no
  50. use putting in more than 256 gadgets...
  51.  
  52. EXAMPLE FILE
  53. ------------
  54.  
  55.   Just in case the original gets changed, I'll insert an example file in this
  56. document. This is of course to be used with FrexxEd:
  57.  
  58. Open:Open("");
  59. Save:Save();
  60. Save As...:SaveAs();
  61. Search...:{ int ret; SearchSet("f+"); if ((ret=SearchSet())>=0) { if (Search()<0) DisplayBeep(); } else ReturnStatus(GetReturnMsg(ret)); }
  62. Search:Search();
  63. Srch/Repl:ReplaceSet();
  64. Mark:BlockMark();
  65. Copy:BlockCopy();
  66. Cut:BlockCut();
  67. Paste:BlockPaste();
  68. Bsave:BlockSave();
  69. FPL file:ExecuteFile();
  70. Globals:PromptInfo(0, "All globals", "(global)", "(read)(hidden)");
  71. Locals:PromptInfo(-1, joinstr("\"", ReadInfo("file_name"), "\" settings."), 0, 0, "!ds_*");
  72. Undo:Undo();
  73. Undo restart:UndoRestart();
  74. About:About();
  75.  
  76.  
  77. History
  78. -------
  79.  
  80. 0.1    First version by Daniel Stenberg
  81. 0.2    Improved very much by Linus Nielsen
  82. 0.3    Made the gadgets resize the widths according to the longest gadget
  83.     text.
  84.  
  85.  
  86.   Redirect complaints to >NIL:, mail us serious bug reports and suggestions
  87. of how to improve this.
  88.  
  89.   Linus Nielsen
  90.   Email: erenie@ere.ericsson.se
  91.  
  92.   Daniel Stenberg
  93.   Email: Daniel.Stenberg@sth.frontec.se
  94.